package cn.gemiman.daoyi.module.cms.service.articlecategory;

import jakarta.validation.*;
import cn.gemiman.daoyi.module.cms.controller.admin.articlecategory.vo.*;
import cn.gemiman.daoyi.module.cms.dal.dataobject.articlecategory.CmsArticleCategoryDO;
import cn.gemiman.daoyi.framework.common.pojo.PageResult;

/**
 * 文章栏目 Service 接口
 *
 * @author 道一源码
 */
public interface CmsArticleCategoryService {

    /**
     * 创建文章栏目
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createArticleCategory(@Valid CmsArticleCategorySaveReqVO createReqVO);

    /**
     * 更新文章栏目
     *
     * @param updateReqVO 更新信息
     */
    void updateArticleCategory(@Valid CmsArticleCategorySaveReqVO updateReqVO);

    /**
     * 删除文章栏目
     *
     * @param id 编号
     */
    void deleteArticleCategory(Long id);

    /**
     * 获得文章栏目
     *
     * @param id 编号
     * @return 文章栏目
     */
    CmsArticleCategoryDO getArticleCategory(Long id);

    /**
     * 获得文章栏目分页
     *
     * @param pageReqVO 分页查询
     * @return 文章栏目分页
     */
    PageResult<CmsArticleCategoryDO> getArticleCategoryPage(CmsArticleCategoryPageReqVO pageReqVO);

}
